home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / tri_bbs / tridog40.zip / TRIDOG.DOC < prev    next >
Encoding:
Text File  |  1992-06-29  |  7.4 KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                  TriDog 4.0
  9.                 A Fido<->TriBBS Message Conversion Program 
  10.                    Copyright (c) 1991 By Mark D. Goodwin
  11.  
  12.      TriDog  is distributed as a  freeware program.  Registered TriBBS
  13.      sysops are  free to use  TriDog with their TriBBS.   Unregistered
  14.      TriBBS  sysops are  free to  use TriDog  during their  board's 30
  15.      evaluation  period.    Any  other  use  of  TriDog  is   strictly
  16.      prohibited.
  17.  
  18.      TriDog is a program that  allows your TriBBS board to participate
  19.      in one of the many FidoNet-type networks.  Essentially, TriDog is
  20.      used to  convert messages  from the Fido  MSG format  to TriBBS's
  21.      message base structure and vice versa.
  22.  
  23.  
  24.      THE TRIDOG DIRECTORY
  25.      ---------------------
  26.  
  27.      The  first  step during  the  TriDog installation  process  is to
  28.      create a directory for the  conversion program and copy the files
  29.      TRIDOG.EXE and RESET.EXE into the newly created directory.
  30.  
  31.  
  32.      THE CONFIGURATION FILE
  33.      ----------------------
  34.  
  35.      Next,  you  must  create  a configuration  file  in  your  TriDog
  36.      directory.  The  configuration file  is the  key to  successfully
  37.      operating TriDog.   This configuration  file is a  straight ASCII
  38.      text file with a name of TRIDOG.CFG.  A sample configuration file
  39.      is included in the TriDog archive and is as follows:
  40.  
  41.      tribbs=c:\tribbs
  42.      address=1:326/304
  43.      tagline=The Lobster Buoy - Home of TriBBS
  44.      conf=25,c:\fd\net326
  45.      conf=21,c:\fd\comm
  46.      conf=22,c:\fd\pdnecho
  47.      conf=23,c:\fd\dr_debug
  48.      conf=24,c:\fd\ooii
  49.  
  50.      You  should  note  that  the  order  of  the  configuration  file
  51.      statements isn't significant.  The following explanations provide
  52.      more  detail  about  each  of  the  TriDog  configuration  file's
  53.      statements:
  54.  
  55.  
  56.      TRIBBS=directory
  57.  
  58.      This is a required configuration  file statement and simply tells
  59.      TriDog where your main TriBBS directory is located.
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.      ADDRESS=network address
  77.  
  78.      This is a required configuration file statement and  simply tells
  79.      TriDog your  network  address.   This  address is  necessary  for
  80.      TriDog to correctly  create Fido-style MSG files.   Additionally,
  81.      TriDog will append your address onto your tagline.
  82.  
  83.  
  84.      TAGLINE=tagline
  85.  
  86.      This is a required configuration file  statement and simply tells
  87.      TriDog the  tagline for your board.  TriDog will put this tagline
  88.      and  your network address  in an appropriate  Origin statement at
  89.      the bottom of every exported message.
  90.  
  91.  
  92.      CONF=TriBBS conference number,Fido MSG directory
  93.  
  94.      You  must  specify  at  least   one  CONF  statement  per  TriDog
  95.      configuration  file.  This statement tells TriDog what conference
  96.      number is  being used on  your board for  the conference  and the
  97.      directory for the Fido conference.
  98.  
  99.  
  100.      RUNNING TRIDOG
  101.      --------------
  102.  
  103.      TriDog  is run by simply  entering the command  TRIDOG at the DOS
  104.      command prompt.   You should probably run TriDog  before you pack
  105.      your Fido conferences,  before you poll your host,  and after you
  106.      poll your  host.  Of course you may  run TriDog at anytime during
  107.      the day, but  running it with  the three mentioned  circumstances
  108.      should be sufficient.
  109.  
  110.  
  111.      HIGH MESSAGE POINTERS AND CRC FILES
  112.      -----------------------------------
  113.  
  114.      To be able  to keep track of  what messages have or  haven't been
  115.      exported from your message base,  TriDog maintains a file of high
  116.      message pointers for  all of your board's conferences  and a file
  117.      of CRCs for each conference  that appears in a configuration file
  118.      CONF statement.  The high message pointer file has  a filename of
  119.      TRIDOG.HGH.  The CRC files have filenames of n.CRC.  Where "n" is
  120.      the  conference's number.  Normally, TriDog maintains these files
  121.      automatically.   However, there  are times when  you may  have to
  122.      manually intervene.
  123.  
  124.      For  example, you may reconfigure your message conferences.  This
  125.      is usually no big  deal.  If, however, the changes  you make move
  126.      your  networked conferences around, the high message pointer file
  127.      will  be incorrect, the configuration file's CONF statements will
  128.      be  incorrect, and  the CRC files  will be  incorrectly numbered.
  129.      The solution to preventing such a problem is to run TriDog before
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.      changing your configuration.  Next you should run RESET.EXE, make
  145.      any appropriate changes to the CONF statements in TRIDOG.CFG, and
  146.      then renumber the CRC files by using the DOS REN command. 
  147.  
  148.      A similar situation may occur if you renumber one or more of your
  149.      networked conferences with  TRIPACK.  (Remember, you  should only
  150.      renumber your message  base conferences if they are  in danger of
  151.      rolling over 999,999.)  Simply  run TriDog, run TRIPACK, and then
  152.      run RESET.
  153.  
  154.      You should also note  that the CRC  files only maintain CRCs  for
  155.      the last  5000 messages per conference.   These CRCs  are used by
  156.      TriDog to prevent already exported messages from being reimported
  157.      and to prevent  already imported messages from  being reimported.
  158.      Because TriDog  only keeps  track of the  last 5000  messages per
  159.      conference, you must be sure that your Fido MSG directories never
  160.      have over 5000 MSG files in each directory.  You should also note
  161.      that there's no need to keep anywhere near 5000 MSG files on hand
  162.      for any  conference.   Old messages  should be  routinely deleted
  163.      with your Fido message  packer.  This will not only  save a great
  164.      deal  of  disk  space,  but   it  will  also  speed  up  TriDog's
  165.      performance considerably.
  166.  
  167.      NETMAIL SUPPORT
  168.      ---------------
  169.  
  170.      Starting  with version  4.0, TriDog supports  TriBBS's Fido-style
  171.      netmail conference  feature.   You should  note however  that the
  172.      current version of  TriDog does not  support point addressing  or
  173.      interzone addressing of netmail.
  174.  
  175.  
  176.      SUPPORT
  177.      -------
  178.  
  179.      If you  have any  problems installing and  using TriDog,  you can
  180.      obtain support by  calling either The Lobster  Buoy, 207-941-0805
  181.      or  sending  a message  to  me at  1:328/104.   Please  only make
  182.      inquiries about TriDog or any other TriBBS related problem. There
  183.      are  many  ways you  can  setup  a  Fido  system.   If  you  need
  184.      assistance with a  nonTriBBS-related program, you  should contact
  185.      the program's author for assistance.
  186.  
  187.      The best advice I can give you is to set up a TriBBS board first.
  188.      Then add  the frontend mail program.  Once you are connected with
  189.      a  net and  are starting  to  receive some  echomail, then  setup
  190.      TriDog to handle  the conversion process.  If you  take the whole
  191.      process a  step  at a  time,  you  shouldn't run  into  too  many
  192.      problems.
  193.  
  194.  
  195.      SPECIAL THANKS
  196.      --------------
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.      I'd like to especially thank Wayne Price (1:326/0 and 1:326/103).
  213.      Wayne runs net 1:326  has been very patient answering a number of
  214.      really dumb questions about FidoNet in general.  I'd also like to
  215.      thank Mark May (1:110/290) who provided me with all of the latest
  216.      FidoNet technical files.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.